home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / gif_vu61.zip / SLIDSHOW.DOC < prev    next >
Text File  |  1992-02-03  |  10KB  |  334 lines
  1. To use MVGAVU's user-definable slideshow feature, a plain text file must
  2. be created.  Each of the commands described below MUST be flushed against
  3. the left margin; NO SPACES MUST PRECEDE or PROCEED COMMANDS.  The text file
  4. MUST be saved as COMMAND.SLD - only this file is recognized by MVGAVU as
  5. the slideshow script.  When you want to try your slideshow script, simply
  6. make sure COMMAND.SLD is in your current dreive/directory and type
  7.  
  8.             MVGAVU -p
  9.  
  10. to let MVGAVU know that you want to run your own slideshow "P"rogram.
  11.  
  12. See TUTORIAL at the end of this DOC for sample scripts.
  13.  
  14.  
  15. COMMENT         Syntax: ;
  16.         Where:  all text following the ";" symbol is treated
  17.             as a comment
  18.  
  19.         eg.     ;THIS IS A COMMENT
  20.  
  21.         Desc:   This feature is lets you place comments anywhere in
  22.             the slideshow program.  It can prove very useful when
  23.             you have LARGE slideshows.
  24.  
  25.  
  26. FILENAME        Syntax: FILENAME=filename
  27.         Where:  filename is any supported GIF, PCX, BMP or TGA file
  28.  
  29.         eg.     FILENAME=test.gif
  30.             FILENAME=d:\windows\test.bmp
  31.             FILENAME=c:\pbrush\test.pcx
  32.             FILENAME=\hicolor\test.tga
  33.  
  34.         Desc:   This function specifies which image is to be shown.
  35.             You can specify a GIF, PCX, BMP or TGA file.  The
  36.             function allows you to include image files from
  37.             several drives/directories; all you have to do
  38.             is specify where it is.
  39.  
  40.  
  41. DURATION        Syntax: DURATION=nn
  42.         Where:  nn=0 to 60 seconds
  43.  
  44.         eg.     DURATION=1
  45.             DURATION=60
  46.  
  47.         Desc:   This function specifies how long a particular image
  48.             is to remain in the active display.  You can display
  49.             the image for as long as 60 seconds (1 minute).
  50.             Since this is a linear script, this command must be
  51.             placed AFTER a specified FILENAME, otherwise a delay
  52.             will be introduced at the wrong time.
  53.  
  54.  
  55. VIDEOMODE       Syntax: VIDEOMODE=v
  56.         Where:  E =  EGA 640x350x16
  57.             V =  VGA 640x480x16
  58.             M = MCGA 320x200x156
  59.             0 =  VGA 320x400x256 (non-standard)
  60.             1 =  VGA 360x480x256 (non-standard)
  61.             3 =  VGA 800x600x16  (EEGA/EVGA)
  62.             4 = SVGA 640x400x256
  63.             5 = SVGA 640x480x256
  64.             6 = SVGA 800x600x256
  65.             7 = SVGA 1KBx768x16
  66.             8 = SVGA 1KBx768x256
  67.             H = SVGA 640x480x32K (HiColor or HercGS)
  68.             I = SVGA 800x600x32K (HiColor)
  69.                  or
  70.             I = HGSC 512x480x24M (HercGS)
  71.             U = USER NNNxNNNxNNN (16/256-color user mode)
  72.  
  73.         eg.     VIDEOMODE=1
  74.             VIDEOMODE=5
  75.             VIDEOMODE=H
  76.  
  77.         Desc:   This command MUST be placed BEFORE the specified
  78.             FILENAME to take effect; otherwise it will affect
  79.             succeeding image files to be shown.  Absence of this
  80.             command will default to AutoMode selection.
  81.             Automode selection can be modified by PROCESS
  82.             commands specified below.
  83.  
  84.  
  85. PROCESS         Syntax: PROCESS=a
  86.         Where:  a = one of the processing options available at the
  87.             MVGAVU expert menu or command line.
  88.  
  89.             SAFETY = "Safety w/ MIGs"
  90.                 This limits AutoMode selection to 640x480 to
  91.                 avoid damage to fixed-frequency analog
  92.                 monitors.  It will also render GIFs with
  93.                 multiple image graphics (MIGs).  This is the
  94.                 default.
  95.  
  96.             NORMAL = "Normal w/ MIGS"
  97.                 This is similar to "SAFETY" but limits
  98.                 AutoMode selection to 800x600x256 or
  99.                 1024x768x16.
  100.  
  101.             ONEMEG = "OneMeg w/ MIGs"
  102.                 This is similar to "NORMAL" without limiting
  103.                 the AutoMode selection.  This will go up to
  104.                 1024x768x256.
  105.  
  106.             HICOLOR = [not avaliable at Expert Menu]
  107.                 This is similar to starting MVGAVU with the
  108.                 "-H" option if HiColor capability was not
  109.                 hardcoded/configured.  The AutoMode
  110.                 selections will be similar to ONEMEG but will
  111.                 include HiCOLOR modes if TGA or 24-bit BMP
  112.                 files are selected.
  113.  
  114.             FITSCREEN = "Fit to Screen"
  115.                 This can be used AFTER any of the AutoMode
  116.                 processing options above - SAFETY, NORMAL,
  117.                 ONEMEG, HICOLOR.  Images will be shrunken or
  118.                 expanded to fit the whole screen.  This is
  119.                 useful for correcting some aspect ratio
  120.                 problems or simple for the effect.  THIS
  121.                 OPTION SHOULD BE USED ON SINGLE IMAGES ONLY
  122.                 - NOT MIGs.
  123.  
  124.             SQUARE = "Fix Aspect 1:1"
  125.                 This is similar to FITSCREEN.  Images will
  126.                 be corrected to have a square or 1:1 aspect
  127.                 ratio; most scanned images with strange
  128.                 screen or image sizes use a square aspect
  129.                 ratio.  Use this when images seem distorted.
  130.  
  131.             TARGA = "Fix Aspect TGA"
  132.                 This is similar to SQUARE but assumes that
  133.                 the images have a TARGA aspect ratio.
  134.  
  135.  
  136.             eg.     PROCESS=ONEMEG
  137.                 PROCESS=SQUARE
  138.  
  139.         Desc:   This command once used will be in effect until
  140.             another PROCESS option is selected. It should be
  141.             placed BEFORE the FILENAME command and AFTER the
  142.             VIDEOMODE command, if used.
  143.  
  144.  
  145. GREYMODE        Syntax: GREYMODE
  146.  
  147.         Desc:   This command forces the rendering of the image to be
  148.             in grey shades.  Unlike PROCESS commands, this
  149.             option will be implemented only with the image
  150.             specified (by FILENAME) immediately following it.
  151.  
  152.  
  153.  
  154. EFFECT          Syntax: EFFECT=a
  155.         Where:  a = Any one of the slideshow transition effects
  156.             supported by MVGAVU.
  157.  
  158.             FADETOBLACK = Palette fades to black
  159.                       (MCGA, VGA and SVGA only)
  160.  
  161.             RANDOMLINES = Random vertical lines clear
  162.                       the screen.
  163.  
  164.             VCURTAIN    = Vertical curtains clear the screen
  165.                       from the top and bottom and meet at
  166.                       the center of the screen.
  167.  
  168.             BLOCKS      = Random blocks clear the screen.
  169.  
  170.             VBLINDS     = Vertical "blinds" clear the screen in
  171.                       an interlaced fashion
  172.  
  173.             RANDOM      = Randomly selects from any of the above
  174.  
  175.  
  176. SLIDESHOW TUTORIAL
  177.  
  178. For the simplest slideshow, all you have to do is specify the images and
  179. the order that they will be displayed.  All images will be rendered with
  180. the SAFETY AutoMode selections.  Let us assume that your COMMAND.SLD file
  181. is at the root of C: - your slideshow script would start off like this
  182.  
  183. ;My first slideshow
  184. FILENAME=\GIF\VGA\MONROE.GIF
  185. ;320x200x256
  186. FILENAME=\GIF\EGA\DARLNG.GIF
  187. ;640x480x16
  188. FILENAME=\GIF\SVGA\DGNLDY.GIF
  189. ;640x720x256
  190. FILENAME=\WINDOWS\BABE.BMP
  191. ;333x480x256
  192. FILENAME=C:\PBRUSH\RAINBOW.PCX
  193. ;1024x768x256
  194. FILENAME=D:\TARGA\STRM1.TGA
  195. ;800x600x32K
  196.  
  197. With the above script, each of the different image files with different
  198. resolutions and colors will be shown in an optimal fashion in the order
  199. specified; it will then cycle through that order until the slideshow is
  200. halted by pressing the <ESC> several times.  Lets now add delays and
  201. transition effects.
  202.  
  203. ;My first slideshow
  204. FILENAME=\GIF\VGA\MONROE.GIF
  205. ;320x200x256
  206. DURATION=5
  207. EFFECTS=FADETOBLACK
  208.  
  209. FILENAME=\GIF\EGA\DARLNG.GIF
  210. ;640x480x16
  211. DURATION=2
  212. EFFECTS=RANDOMLINES
  213.  
  214. FILENAME=\GIF\SVGA\DGNLDY.GIF
  215. ;640x720x256
  216. DURATION=2
  217. EFFECTS=VBLINDS
  218. ;use VBLINDS since this is an interlaced image
  219.  
  220. FILENAME=\WINDOWS\BABE.BMP
  221. ;333x480x256
  222. DURATION=3
  223. EFFECTS=RANDOM
  224.  
  225. FILENAME=C:\PBRUSH\RAINBOW.PCX
  226. ;1024x768x256
  227. DURATION=3
  228. EFFECTS=RANDOM
  229.  
  230. FILENAME=D:\TARGA\STRM1.TGA
  231. DURATION=8
  232. EFFECTS=BLOCKS
  233. ;800x600x32K
  234.  
  235.  
  236. The above script will show each slide with specified durations and will
  237. add a transition effect after the specified duration.  Lets assume that
  238. you have a PS/2 Model 50 - ie., you can only go as high as 360x480x256.
  239.  
  240. Since your maximum resolution will not fit the whole DGNLDY.GIF image
  241. on the screen, it is interpolated to "fit the screen" - resulting in
  242. some distortion.  You would want to use the PROCESS=SQUARE command.
  243.  
  244. ;My first slideshow
  245. FILENAME=\GIF\VGA\MONROE.GIF
  246. ;320x200x256
  247. DURATION=5
  248. EFFECTS=FADETOBLACK
  249.  
  250. FILENAME=\GIF\EGA\DARLNG.GIF
  251. ;640x480x16
  252. DURATION=2
  253. EFFECTS=RANDOMLINES
  254.  
  255. PROCESS=SQUARE
  256. ;correct the display of this image
  257. FILENAME=\GIF\SVGA\DGNLDY.GIF
  258. ;640x720x256
  259. DURATION=2
  260. EFFECTS=VBLINDS
  261. ;use VBLINDS since this is an interlaced image
  262.  
  263. PROCESS=SAFETY
  264. ;reset PROCESS to "Safety w/ MIGs"
  265. FILENAME=\WINDOWS\BABE.BMP
  266. ;333x480x256
  267. DURATION=3
  268. EFFECTS=RANDOM
  269.  
  270. FILENAME=C:\PBRUSH\RAINBOW.PCX
  271. ;1024x768x256
  272. DURATION=3
  273. EFFECTS=RANDOM
  274.  
  275. FILENAME=D:\TARGA\STRM1.TGA
  276. DURATION=8
  277. EFFECTS=BLOCKS
  278. ;800x600x32K
  279.  
  280. In the above script, we set PROCESS=SQUARE to display DGNLDY.GIF optimally
  281. by using MVGAVU's aspect ratio correcting routines.  We then set it back
  282. to normal when showing the next slide.  Although MVGAVU renders STRM1.TGA
  283. in your maximum 256-color mode (360x480x256) with an acceptable quality
  284. (given the limits of your video card), you opt to see more DETAIL at a
  285. a higher resolution - but in grey shades.
  286.  
  287. ;My first slideshow
  288. FILENAME=\GIF\VGA\MONROE.GIF
  289. ;320x200x256
  290. DURATION=5
  291. EFFECTS=FADETOBLACK
  292.  
  293. FILENAME=\GIF\EGA\DARLNG.GIF
  294. ;640x480x16
  295. DURATION=2
  296. EFFECTS=RANDOMLINES
  297.  
  298. PROCESS=SQUARE
  299. ;correct the display of this image
  300. FILENAME=\GIF\SVGA\DGNLDY.GIF
  301. ;640x720x256
  302. DURATION=2
  303. EFFECTS=VBLINDS
  304. ;use VBLINDS since this is an interlaced image
  305.  
  306. PROCESS=SAFETY
  307. ;reset PROCESS to "Safety w/ MIGs"
  308. FILENAME=\WINDOWS\BABE.BMP
  309. ;333x480x256
  310. DURATION=3
  311. EFFECTS=RANDOM
  312.  
  313. FILENAME=C:\PBRUSH\RAINBOW.PCX
  314. ;1024x768x256
  315. DURATION=3
  316. EFFECTS=RANDOM
  317.  
  318. GREYMODE
  319. VIDEOMODE=V
  320. FILENAME=D:\TARGA\STRM1.TGA
  321. DURATION=8
  322. EFFECTS=BLOCKS
  323. ;800x600x32K
  324.  
  325. In the above script, STRM1.TGA is displayed using mode "V" for 640x480x16
  326. grey shades - you therefore get more detail at a higher resolution.
  327.  
  328. Thus, aside from the individual control over each image file to be displayed,
  329. you have virtually all the power that MVGAVU's expert menu can provide in
  330. rendering an image - to optimize you specific video card hardware.
  331.  
  332. Enjoy.
  333.  
  334.